home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / os2tg_10.zip / SIO153.ZIP / VMODEM.TXT < prev    next >
Text File  |  1995-08-16  |  39KB  |  900 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                       VMODEM
  25.                            Technical Reference Manual
  26.  
  27.  
  28.  
  29.                      Copyright (c) 1995 by Raymond L. Gwinn
  30.                                 26 Tanager Place
  31.                           Beckley, West Virginia 25801
  32.                                All Rights Reserved
  33.  
  34.                                  August 10, 1995
  35.  
  36.  
  37.                               CompuServe: 71154,575
  38.                              InterNet: ray@gwinn.com
  39.                               Voice: 1-304-255-7900
  40.                                FAX: 1-304-255-7902
  41.                       BBS: 1-304-255-7903 or 199.248.240.2
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                   INTRODUCTION
  58.  
  59.      The Virtual Modem is a concept that the author believes will change
  60.      the way serial data communications is done and thought of.  It is
  61.      going to bring the Internet alive more then ever before.  Perhaps it
  62.      will not be this implementation of a Virtual Modem, but the concept
  63.      will remain and be used for a long time.  The concept of the Virtual
  64.      Modem was born from the desire to make the SIO support BBS available
  65.      via Internet.  In only a few minutes, I was convinced the Virtual
  66.      Modem was a solution of a multitude of problems that Internet access
  67.      poses.
  68.  
  69.      The Virtual Modem removes most of the complexities and mysteries of
  70.      the Internet by allowing common, well understood, programs to be used
  71.      to access the Internet highway.  Users can use programs like PmComm
  72.      and TE/2 to download files from a BBS (across the Internet) using
  73.      common protocols like ZMODEM.  The dialing directories of terminal
  74.      programs can contain Internet addresses instead of phone numbers for
  75.      easy access to remote sites.
  76.  
  77.      BBS SysOps can simply declare one or more of their BBS's
  78.      communications ports as a Virtual Modem and users can then "dial" in
  79.      over the Internet and no BBS software changes should be necessary.  Is
  80.      your BBS ready for 20 million new users that can access it without
  81.      making a long distance call?  This Virtual Modem implements protocols,
  82.      including a Telnet server which allows most anyone on Internet to
  83.      access your system.
  84.  
  85.      Users transferring large volumes of data across phone lines (like
  86.      FidoNet echomail) can now use the Internet highway instead.  Again,
  87.      software changes should be minimal, if any at all.
  88.  
  89.      Vmodem is unique in that it has a dual personality of both Server and
  90.      Client.  The Server/Client personality is determined by the direction
  91.      of the connection (outgoing or incoming).
  92.  
  93.  
  94.  
  95.  
  96.      ii
  97.  
  98.                                 TABLE OF CONTENTS
  99.  
  100.      WHAT IS VMODEM  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  101.  
  102.      DISTRIBUTION, ORDERING AND SUPPORT  . . . . . . . . . . . . . . .    2
  103.           Distribution and Ordering  . . . . . . . . . . . . . . . . .    2
  104.                SIO Distribution and Support BBS  . . . . . . . . . . .    2
  105.           Support  . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  106.  
  107.      GETTING IT GOING  . . . . . . . . . . . . . . . . . . . . . . . .    5
  108.           TCP/IP Required  . . . . . . . . . . . . . . . . . . . . . .    5
  109.                TCP/IP Sockets  . . . . . . . . . . . . . . . . . . . .    5
  110.                The default port number . . . . . . . . . . . . . . . .    5
  111.  
  112.      The SIO.SYS command line  . . . . . . . . . . . . . . . . . . . .    5
  113.  
  114.      THE VIRTUAL MODEM . . . . . . . . . . . . . . . . . . . . . . . .    7
  115.           AT Commands Supported  . . . . . . . . . . . . . . . . . . .    7
  116.           S Registers Supported  . . . . . . . . . . . . . . . . . . .    8
  117.           Result Codes . . . . . . . . . . . . . . . . . . . . . . . .    8
  118.                NO CARRIER  . . . . . . . . . . . . . . . . . . . . . .    8
  119.                NO DIALTONE . . . . . . . . . . . . . . . . . . . . . .    8
  120.                  . . . . . . . . . . . . . . . . . . . . . . . . . . .    8
  121.                BUSY  . . . . . . . . . . . . . . . . . . . . . . . . .    8
  122.                CONNECT 57600/ARQ/VMP . . . . . . . . . . . . . . . . .    8
  123.                CONNECT 57600/ARQ/TEL . . . . . . . . . . . . . . . . .    8
  124.                RING  . . . . . . . . . . . . . . . . . . . . . . . . .    8
  125.                RINGING . . . . . . . . . . . . . . . . . . . . . . . .    8
  126.           Caveats  . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  127.  
  128.      SECURITY  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  129.           Discussion . . . . . . . . . . . . . . . . . . . . . . . . .   11
  130.           Vmodem's Implementation  . . . . . . . . . . . . . . . . . .   11
  131.           Developers Information . . . . . . . . . . . . . . . . . . .   11
  132.  
  133.      DIALING EXAMPLES  . . . . . . . . . . . . . . . . . . . . . . . .   12
  134.  
  135.      Telnet  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  136.           IBM's Telnet Client  . . . . . . . . . . . . . . . . . . . .   13
  137.  
  138.      Development and Debugging Tools . . . . . . . . . . . . . . . . .   14
  139.           Vmodem's Semaphores  . . . . . . . . . . . . . . . . . . . .   14
  140.           The Poor Man's Line Monitor (PMLM.EXE) . . . . . . . . . . .   14
  141.           VIEWPMLM.EXE . . . . . . . . . . . . . . . . . . . . . . . .   15
  142.           SIO's Utility (SU.EXE) . . . . . . . . . . . . . . . . . . .   15
  143.                IRQs that currently free for use  . . . . . . . . . . .   15
  144.  
  145.      Appendix A, Hardware Port and IRQ Assignments . . . . . . . . . .   16
  146.           Addresses and IRQs for COM1 and COM2 . . . . . . . . . . . .   16
  147.           Defacto standard for COM3 and COM4 . . . . . . . . . . . . .   16
  148.           Addresses and IRQ for COM3 through COM8 on the PS/2  . . . .   16
  149.  
  150.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  151.  
  152.  
  153.  
  154.  
  155.                                                                           1
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.                                  WHAT IS VMODEM
  169.  
  170.      Vmodem is a software implementation of a modem, referred to as a
  171.      Virtual Modem.  Basically, it attempts to fake out other software
  172.      (like terminal programs) into believing they are accessing a real
  173.      modem.  Vmodem will turn any Terminal into a Telnet Client, and any
  174.      BBS into a Telnet Server.
  175.  
  176.      Normal (real) modems provide an interface that allows terminal
  177.      programs to pass digital information across telephone lines.  Vmodem
  178.      does the same thing from the application (terminal) program's point of
  179.      view.  However, the other side of Vmodem is not a phone line, but a
  180.      digital network like Internet.  Thus, Vmodem allows the hoards of
  181.      communications programs to pass information across Internet instead of
  182.      using phone lines.
  183.  
  184.      In addition to acting as a Telnet server, Vmodem uses a newly designed
  185.      protocol for communications networks, called the Virtual Modem
  186.      Protocol (VMP).  At this time, no other programs have implemented VMP,
  187.      thus Vmodem is required on both ends of the connection to use the VMP. 
  188.       However, VMODEM.EXE will accept inbound Telnet connections from any
  189.      system, meaning a BBS under vmodem can be accessed by just about
  190.      anyone with an Internet connection.
  191.  
  192.      Future implementations of Vmodem may access networks other than
  193.      Internet and use TCP/IP implementations other than IBM's.  The current
  194.      implementation of Vmodem works only on Internet, using the Internet
  195.      Access Kit (IAK) that is included with OS/2 V3 and IBM's TCP/IP (for
  196.      OS/2) version 2.0, with the August 1994 CSD applied.
  197.  
  198.      A single invocation of Vmodem can service all of the Internet ports
  199.      defined in the SIO command line.
  200.  
  201.  
  202.  
  203.  
  204.      2
  205.  
  206.                        DISTRIBUTION, ORDERING AND SUPPORT
  207.  
  208.      Distribution and Ordering
  209.  
  210.      Vmodem is a part of a larger package collectively known as SIO.  The
  211.      entire package collectively known as SIO is ShareWare.  It is not free
  212.      software or free